home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 June / macformat-038.iso / Shareware City / Utilities / file-indexer-14 / FileIndexer 1.4 / User Guide (SimpleText) < prev   
Encoding:
Text File  |  1996-03-31  |  4.1 KB  |  118 lines  |  [ttro/ttxt]

  1.  
  2.  
  3.  
  4.  
  5. FileIndexer indexes the full text of collections of documents on your disks. By using Claris XTND the program can read any document you have translators for. Indexing takes some time, and can run in the background without much impact. Finding the list of files that contain the word you are looking for is fast.
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19. Creating an index
  20.  
  21. Run FileIndexer, choose Index folder, and select the top folder in a tree of text files to be indexed. Claris XTND can be used (if available) to read documents. You need to turn it on in the preferences dialog to use it. 
  22.  
  23. You can alternately drag a folder from the Finder™ to anywhere in the document window to start indexing all documents in the folder heirarchy below that folder.
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. The upper bar shows progress through the current file, name shown above, the lower bar shows the overall progress through the files you gave it. Files that are not text and cannot be read with XTND (if you turn it on) are skipped.
  32.  
  33. When done, type a word or words into the find field and press return. A list of all the files that contain the words will be displayed. The first occurence of the first word will be shown in context. An info checkbox lets you see file mod date and the full path to the file as an alternative.
  34.  
  35. Note that when you search for multiple words, only those files that contain all of the words are shown.
  36.  
  37. Double-click on the file (or highlight and press return) to open the first 32k of it in a text window. You can also choose  to view the document in it’s original app or the app of your choice, (set in preferences).
  38.  
  39. From the text window you can use Find or Find again (command-G) to locate the word you searched for.
  40.  
  41. Stop Words
  42.  
  43. You can reduce the index size by putting a text file called “Stop Words” in the same folder as the application. Any words in this file will not be indexed. I’ve enclosed a file I built, but you may wish to add to it.
  44.  
  45. Preferences
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. • Shortest word to index: Don’t index words less than this length.
  70. • Longest word to index: Don’t index words longer than this.
  71. • Include words starting with digits: Avoids lots of junk from internet messages.
  72. • Ignore case: Indexes all words in lower case.
  73. • Use XTND: Use Claris XTND to index and view documents. Dim if not there.
  74. • Stem words: Chops off common word endings. (STR# 3002)
  75. • Scroll to found word: Scrolls to first occurrence when you open a document.
  76. • Check Hits: Check that found words really do contain the searched word.
  77. • Index speed: The number of words to index on each idle.
  78. • View in FileIndexer: Shows first 32k in a styled text window. Scrolls and saves.
  79. • View in creator application: Gets the Finder to open the document.
  80. • View with chosen app: Click the button to choose the app to use.
  81.  
  82. I built a PowerPC native version but it was slower! Probably due to my heavy use of the non-native file manager.
  83.  
  84. Limitations
  85.  
  86. • Requires System 7, will run in black & white on a 68000.
  87. • To create an index on a volume other than the system volume, save to the system volume, close the document, copy the index to the other disk and open it there.
  88.  
  89. AppleScript
  90.  
  91. The program can do searches and return the names and full paths of documents that were found. The support is pretty basic, but probably enough to use it for useful things like web server searches etc.
  92.  
  93. Power Users
  94.  
  95. The list of word stems to be removed if stemming is on are in the string list resource STR# 3002.
  96.  
  97. The list of text file extensions to not index are in the string list resource STR# 3003. This currently has “.pdf”, “.tar”, and “.ps”.
  98.  
  99. Tools
  100.  
  101. Metrowerks Codewarrior 8 C++
  102. Apple Computer Inc. MacApp 3.3
  103. Gettys Group Software Inc. Hunk Manager
  104.  
  105. Credits
  106.  
  107. Written by Peter Marks. 
  108.  
  109. Thanks for the valuable testing and feedback to:
  110.  
  111. Gregory Kearney, Allan Herman, Alastair Rankine, Steve “it’s a tree” Coy, Geert Jan Bex, Keith F. Batchelder, Tony Stevenson, Federico Cavaglia', Farhad Anklesaria, Dave Abrahams, MetaTheory, Jim Coplien, George Bray, you...
  112.  
  113. This freeware is supplied as is, use at your own risk.
  114. Please contact me for permission to include on commercial collections.
  115.  
  116. mailto: Peter.Marks@PoBox.com
  117. © 1995, 1996 Peter Marks
  118. Hunk Manager © Gettys Group Software 1990-91